@fieldwangai/agentflow 0.1.69 → 0.1.71

package/bin/lib/apply.mjs

@@ -24,6 +24,7 @@ import { printEntryAndFlowFiles, printNodeStatusTable, runValidateFlowAndExitIfI
 import { clearApplyActiveLock, writeApplyActiveLock } from "./run-apply-active-lock.mjs";
 import { ensureReference, findFlowNameByUuid, getFlowDir, getRunDir } from "./workspace.mjs";
 import { readMergedEnvObject } from "./user-env.mjs";
+import { appendRunLedgerEvent } from "./run-ledger.mjs";
 
 const PARALLEL_PREFIX_COLORS = [
   (s) => chalk.cyan(s),
@@ -72,6 +73,31 @@ export async function apply(workspaceRoot, flowName, uuidArg, dryRun, agentModel
   // 提前 ensure：apply-start 携带原始 run 起始时间，UI 计时器可按「这个 uuid 从头到现在的总时长」显示，
   // 避免每次 resume 仅从 totalExecutedMs 累加看起来像从 resume 才开始计时。
   const priorRunStartTime = ensureRunStartTime(workspaceRoot, flowName, uuid);
+  let runStartTime = priorRunStartTime;
+  let totalExecutedMs = priorTotalExecutedMs;
+  const writeRunLedger = !dryRun;
+  let runLedgerFinished = false;
+  const runLedgerBase = {
+    kind: "pipeline",
+    runId: uuid,
+    userId: String(process.env.AGENTFLOW_USER_ID || ""),
+    username: String(process.env.AGENTFLOW_USER_ID || ""),
+    flowId: flowName,
+    flowSource: "user",
+    at: priorRunStartTime,
+  };
+  if (writeRunLedger) appendRunLedgerEvent({ ...runLedgerBase, type: "run_started" });
+  const finishRunLedger = (status) => {
+    if (!writeRunLedger || runLedgerFinished) return;
+    runLedgerFinished = true;
+    appendRunLedgerEvent({
+      ...runLedgerBase,
+      type: "run_finished",
+      endedAt: Date.now(),
+      durationMs: totalExecutedMs,
+      status,
+    });
+  };
   emitEvent(workspaceRoot, flowName, uuid, {
     event: "apply-start",
     flowName,
@@ -85,8 +111,6 @@ export async function apply(workspaceRoot, flowName, uuidArg, dryRun, agentModel
   writeApplyActiveLock(workspaceRoot, flowName, uuid);
 
   try {
-  let runStartTime = priorRunStartTime;
-  let totalExecutedMs = priorTotalExecutedMs;
   let round = 0;
   while (round < MAX_LOOP_ROUNDS) {
     round++;
@@ -100,6 +124,7 @@ export async function apply(workspaceRoot, flowName, uuidArg, dryRun, agentModel
     if (readyNodes.length === 0) {
       if (allDone) {
         saveTotalExecutedMs(workspaceRoot, flowName, uuid, totalExecutedMs);
+        finishRunLedger("success");
         const totalElapsed = formatDuration(totalExecutedMs);
         emitEvent(workspaceRoot, flowName, uuid, {
           event: "apply-done",
@@ -163,6 +188,7 @@ export async function apply(workspaceRoot, flowName, uuidArg, dryRun, agentModel
             if (options.length === 0) {
               log.info(chalk.yellow(`节点 ${pendId} 未配置任何选项（output 槽位），无法选择。请先在编辑器中添加 output 槽位。`));
               log.info(chalk.bold.yellow("→ " + t("flow.resume_hint") + " ") + resumeExample);
+              finishRunLedger("interrupted");
               return;
             }
 
@@ -177,6 +203,7 @@ export async function apply(workspaceRoot, flowName, uuidArg, dryRun, agentModel
               }
               process.stderr.write(chalk.bold.cyan("━━━━━━━━━━━━━━━━━━━━━━━━━\n"));
               log.info(chalk.bold.yellow("→ " + t("flow.resume_hint") + " ") + resumeExample);
+              finishRunLedger("interrupted");
               return;
             }
 
@@ -209,6 +236,7 @@ export async function apply(workspaceRoot, flowName, uuidArg, dryRun, agentModel
                 if (trimmed === "q") {
                   rl.close();
                   log.info(chalk.yellow("用户取消，流程暂停。") + chalk.dim(` 恢复命令: ${resumeExample}`));
+                  finishRunLedger("interrupted");
                   return;
                 }
                 const idx = parseInt(trimmed, 10);
@@ -250,6 +278,7 @@ export async function apply(workspaceRoot, flowName, uuidArg, dryRun, agentModel
                 }
                 process.stderr.write(chalk.bold.cyan("━━━━━━━━━━━━━━━━━━━━━━━━━\n"));
                 log.info(chalk.bold.yellow("→ " + t("flow.resume_hint") + " ") + resumeExample);
+                finishRunLedger("interrupted");
                 return;
               }
 
@@ -380,6 +409,7 @@ ${currentContent}
                 } else if (answer.trim().toLowerCase() === "q") {
                   rl.close();
                   log.info(chalk.yellow("用户取消，流程暂停。") + chalk.dim(` 恢复命令: ${resumeExample}`));
+                  finishRunLedger("interrupted");
                   return;
                 }
               }
@@ -393,6 +423,7 @@ ${currentContent}
         }
 
         log.info(chalk.bold.yellow("→ " + t("flow.resume_hint") + " ") + resumeExample);
+        finishRunLedger("interrupted");
         return;
       }
       const endNodeIds = Array.isArray(parseOut.nodes)
@@ -401,6 +432,7 @@ ${currentContent}
       const endReached = endNodeIds.some((id) => instanceStatus[id] === "success");
       if (endReached) {
         saveTotalExecutedMs(workspaceRoot, flowName, uuid, totalExecutedMs);
+        finishRunLedger("success");
         const totalElapsed = formatDuration(totalExecutedMs);
         emitEvent(workspaceRoot, flowName, uuid, {
           event: "apply-done",
@@ -763,6 +795,7 @@ ${currentContent}
   maxErr.uuid = uuid;
   throw maxErr;
   } finally {
+    finishRunLedger("failed");
     clearApplyActiveLock(workspaceRoot, flowName, uuid);
   }
 }

package/bin/lib/catalog-flows.mjs

@@ -158,6 +158,7 @@ function normalizeFrontmatterSlots(arr) {
     else if (typeof def !== "string") def = String(def);
     const slot = { type, name, default: def };
     if (item.required != null) slot.required = Boolean(item.required);
+    if (item.description != null) slot.description = String(item.description);
     slot.showOnNode = item.showOnNode != null ? Boolean(item.showOnNode) : defaultShowOnNodeForSlot(slot);
     return slot;
   });

package/bin/lib/locales/en.json

@@ -289,6 +289,14 @@
       "displayName": "Create GitLab MR",
       "description": "Create or reuse a GitLab merge request for the current branch and output its URL"
     },
+    "tool_wecom_send_group_markdown": {
+      "displayName": "WeCom Group Markdown",
+      "description": "Send a Markdown message through a WeCom group robot webhook"
+    },
+    "tool_wecom_send_app_markdown": {
+      "displayName": "WeCom App Markdown",
+      "description": "Send a Markdown message to users through a WeCom enterprise application"
+    },
     "tool_nodejs": {
       "displayName": "Node.js Script",
       "description": "Execute Node.js script, success determined by exit code, stdout as result"

package/bin/lib/locales/zh.json

@@ -289,6 +289,14 @@
       "displayName": "提交 GitLab MR",
       "description": "为当前分支创建或复用 GitLab Merge Request，并输出 MR 链接"
     },
+    "tool_wecom_send_group_markdown": {
+      "displayName": "企业微信群 Markdown",
+      "description": "通过企业微信群机器人 webhook 发送 Markdown 消息"
+    },
+    "tool_wecom_send_app_markdown": {
+      "displayName": "企业微信应用 Markdown",
+      "description": "通过企业微信应用消息接口发送 Markdown 给用户"
+    },
     "tool_nodejs": {
       "displayName": "Node.js 脚本",
       "description": "执行 Node.js 脚本，以 exit code 判断成败，stdout 作为结果"

package/bin/lib/marketplace.mjs

@@ -72,6 +72,7 @@ function normalizeSlotList(value) {
       default: def == null ? "" : String(def),
     };
     if (slot.required != null) normalized.required = Boolean(slot.required);
+    if (slot.description != null) normalized.description = String(slot.description);
     normalized.showOnNode = slot.showOnNode != null
       ? Boolean(slot.showOnNode)
       : Boolean(normalized.required) || type.toLowerCase() === "node";

package/bin/lib/paths.mjs

@@ -302,6 +302,8 @@ export const LOCAL_ONLY_DEFINITION_IDS = new Set([
   "tool_git_worktree_load",
   "tool_git_worktree_unload",
   "tool_gitlab_create_mr",
+  "tool_wecom_send_group_markdown",
+  "tool_wecom_send_app_markdown",
   "tool_print",
   "tool_user_check",
   "tool_user_ask",

package/bin/lib/run-ledger.mjs

@@ -0,0 +1,96 @@
+import fs from "fs";
+import path from "path";
+import crypto from "crypto";
+
+import { getAgentflowDataRoot } from "./paths.mjs";
+
+function localDayKey(timeMs) {
+  const d = new Date(Number(timeMs) || Date.now());
+  const y = d.getFullYear();
+  const m = String(d.getMonth() + 1).padStart(2, "0");
+  const day = String(d.getDate()).padStart(2, "0");
+  return `${y}-${m}-${day}`;
+}
+
+function safeSegment(value, fallback = "run") {
+  return String(value || fallback)
+    .trim()
+    .replace(/[^a-zA-Z0-9._-]+/g, "_")
+    .replace(/^_+|_+$/g, "")
+    .slice(0, 120) || fallback;
+}
+
+export function runLedgerId(prefix = "run") {
+  return `${safeSegment(prefix, "run")}-${Date.now().toString(36)}-${crypto.randomBytes(4).toString("hex")}`;
+}
+
+export function runLedgerDir() {
+  return path.join(getAgentflowDataRoot(), "admin", "run-ledger");
+}
+
+export function runLedgerPath(timeMs = Date.now()) {
+  return path.join(runLedgerDir(), `${localDayKey(timeMs)}.jsonl`);
+}
+
+export function appendRunLedgerEvent(event = {}) {
+  try {
+    const item = {
+      version: 1,
+      type: String(event.type || ""),
+      kind: String(event.kind || ""),
+      runId: String(event.runId || runLedgerId()),
+      userId: String(event.userId || ""),
+      username: String(event.username || event.userId || ""),
+      flowId: String(event.flowId || ""),
+      flowSource: String(event.flowSource || "user"),
+      runNodeId: String(event.runNodeId || ""),
+      at: Number(event.at || event.startedAt || Date.now()),
+      endedAt: event.endedAt == null ? null : Number(event.endedAt),
+      durationMs: Math.max(0, Number(event.durationMs || 0)),
+      status: event.status ? String(event.status || "") : "",
+    };
+    if (!item.type || !item.kind || !item.runId || !item.flowId) return;
+    const filePath = runLedgerPath(item.at);
+    fs.mkdirSync(path.dirname(filePath), { recursive: true });
+    fs.appendFileSync(filePath, JSON.stringify(item) + "\n", "utf-8");
+  } catch {
+    // Usage telemetry must never affect the run itself.
+  }
+}
+
+function readJsonlObjects(filePath) {
+  if (!fs.existsSync(filePath)) return [];
+  try {
+    const out = [];
+    const lines = fs.readFileSync(filePath, "utf-8").split(/\r?\n/);
+    for (const line of lines) {
+      if (!line.trim()) continue;
+      try {
+        const parsed = JSON.parse(line);
+        if (parsed && typeof parsed === "object" && !Array.isArray(parsed)) out.push(parsed);
+      } catch {
+        /* ignore malformed line */
+      }
+    }
+    return out;
+  } catch {
+    return [];
+  }
+}
+
+export function readRunLedgerEvents(options = {}) {
+  const dir = runLedgerDir();
+  if (!fs.existsSync(dir)) return [];
+  try {
+    const sinceMs = Number(options?.sinceMs || 0);
+    const sinceKey = Number.isFinite(sinceMs) && sinceMs > 0 ? localDayKey(sinceMs) : "";
+    const files = fs.readdirSync(dir, { withFileTypes: true })
+      .filter((entry) => entry.isFile() && /^\d{4}-\d{2}-\d{2}\.jsonl$/.test(entry.name))
+      .filter((entry) => !sinceKey || entry.name.slice(0, 10) >= sinceKey)
+      .map((entry) => path.join(dir, entry.name))
+      .sort();
+    return files.flatMap((filePath) => readJsonlObjects(filePath));
+  } catch {
+    return [];
+  }
+}